home *** CD-ROM | disk | FTP | other *** search
/ La Traviata / La Traviata.iso / viewer / gif_doc.zip / GIF.DOC < prev    next >
Text File  |  1990-11-25  |  31KB  |  526 lines

  1.                                 G I F (tm)
  2.                      Graphics Interchange Format (tm)
  3.                       A standard defining a mechanism
  4.                      for the storage and transmission
  5.                    of raster-based graphics information
  6.                                June 15, 1987
  7.                      (c) CompuServe Incorporated, 1987
  8.                             All rights reserved
  9.             While this document is copyrighted, the information
  10.           contained within is made available for use in computer
  11.           software without royalties, or licensing restrictions.
  12.           GIF and 'Graphics Interchange Format' are trademarks of
  13.                          CompuServe, Incorporated.
  14.                            an H&R Block Company
  15.                         5000 Arlington Centre Blvd.
  16.                            Columbus, Ohio 43220
  17.                               (614) 457-8600
  18.                                                                      Page 2
  19.               Graphics Interchange Format (GIF) Specification
  20.                              Table of Contents
  21.         INTRODUCTION . . . . . . . . . . . . . . . . . page 3
  22.         GENERAL FILE FORMAT  . . . . . . . . . . . . . page 3
  23.         GIF SIGNATURE  . . . . . . . . . . . . . . . . page 4
  24.         SCREEN DESCRIPTOR  . . . . . . . . . . . . . . page 4
  25.         GLOBAL COLOR MAP . . . . . . . . . . . . . . . page 5
  26.         IMAGE DESCRIPTOR . . . . . . . . . . . . . . . page 6
  27.         LOCAL COLOR MAP  . . . . . . . . . . . . . . . page 7
  28.         RASTER DATA  . . . . . . . . . . . . . . . . . page 7
  29.         GIF TERMINATOR . . . . . . . . . . . . . . . . page 8
  30.         GIF EXTENSION BLOCKS . . . . . . . . . . . . . page 8
  31.         APPENDIX A - GLOSSARY  . . . . . . . . . . . . page 9
  32.         APPENDIX B - INTERACTIVE SEQUENCES . . . . . . page 10
  33.         APPENDIX C - IMAGE PACKAGING & COMPRESSION . . page 12
  34.         APPENDIX D - MULTIPLE IMAGE PROCESSING . . . . page 15
  35. Graphics Interchange Format (GIF)                                    Page 3
  36. Specification
  37. INTRODUCTION
  38.         'GIF' (tm) is CompuServe's standard for defining generalized  color
  39.    raster   images.    This   'Graphics  Interchange  Format'  (tm)  allows
  40.    high-quality, high-resolution graphics to be displayed on a  variety  of
  41.    graphics  hardware  and is intended as an exchange and display mechanism
  42.    for graphics images.  The image format described  in  this  document  is
  43.    designed  to  support  current  and  future image technology and will in
  44.    addition serve as a basis for future CompuServe graphics products.
  45.         The main focus  of  this  document  is  to  provide  the  technical
  46.    information  necessary  for  a  programmer to implement GIF encoders and
  47.    decoders.  As such, some assumptions are made as to terminology relavent
  48.    to graphics and programming in general.
  49.         The first section of this document describes the  GIF  data  format
  50.    and its components and applies to all GIF decoders, either as standalone
  51.    programs or as part of  a  communications  package.   Appendix  B  is  a
  52.    section  relavent to decoders that are part of a communications software
  53.    package and describes the protocol requirements for entering and exiting
  54.    GIF mode, and responding to host interrogations.  A glossary in Appendix
  55.    A defines some of the terminology used in  this  document.   Appendix  C
  56.    gives  a  detailed  explanation  of  how  the  graphics  image itself is
  57.    packaged as a series of data bytes.
  58.                 Graphics Interchange Format Data Definition
  59.  GENERAL FILE FORMAT
  60.         +-----------------------+
  61.         | +-------------------+ |
  62.         | |   GIF Signature   | |
  63.         | +-------------------+ |
  64.         | +-------------------+ |
  65.         | | Screen Descriptor | |
  66.         | +-------------------+ |
  67.         | +-------------------+ |
  68.         | | Global Color Map  | |
  69.         | +-------------------+ |
  70.         . . .               . . .
  71.         | +-------------------+ |    ---+   
  72.         | |  Image Descriptor | |       |   
  73.         | +-------------------+ |       |   
  74.         | +-------------------+ |       |  
  75.         | |  Local Color Map  | |       |-   Repeated 1 to n times
  76.         | +-------------------+ |       |   
  77.         | +-------------------+ |       |   
  78.         | |    Raster Data    | |       |   
  79.         | +-------------------+ |    ---+   
  80.         . . .               . . .   
  81.         |-    GIF Terminator   -|   
  82.         +-----------------------+
  83. Graphics Interchange Format (GIF)                                    Page 4
  84. Specification
  85.  GIF SIGNATURE
  86.         The following GIF Signature identifies  the  data  following  as  a
  87.    valid GIF image stream.  It consists of the following six characters:
  88.              G I F 8 7 a
  89.         The last three characters '87a' may be viewed as a  version  number
  90.    for  this  particular  GIF  definition  and will be used in general as a
  91.    reference  in  documents  regarding  GIF  that   address   any   version
  92.    dependencies.
  93.  SCREEN DESCRIPTOR
  94.         The Screen Descriptor describes the overall parameters for all  GIF
  95.    images  following.  It defines the overall dimensions of the image space
  96.    or logical screen required, the existance of color mapping  information,
  97.    background  screen color, and color depth information.  This information
  98.    is stored in a series of 8-bit bytes as described below.
  99.               bits
  100.          7 6 5 4 3 2 1 0  Byte #
  101.         +---------------+
  102.         |               |  1
  103.         +-Screen Width -+      Raster width in pixels (LSB first)
  104.         |               |  2
  105.         +---------------+
  106.         |               |  3
  107.         +-Screen Height-+      Raster height in pixels (LSB first)
  108.         |               |  4
  109.         +-+-----+-+-----+      M = 1, Global color map follows Descriptor
  110.         |M|  cr |0|pixel|  5   cr+1 = # bits of color resolution
  111.         +-+-----+-+-----+      pixel+1 = # bits/pixel in image
  112.         |   background  |  6   background=Color index of screen background
  113.         +---------------+          (color is defined from the Global color
  114.         |0 0 0 0 0 0 0 0|  7        map or default map if none specified)
  115.         +---------------+
  116.         The logical screen width and height can both  be  larger  than  the
  117.    physical  display.   How  images  larger  than  the physical display are
  118.    handled is implementation dependent and can take advantage  of  hardware
  119.    characteristics  (e.g.   Macintosh scrolling windows).  Otherwise images
  120.    can be clipped to the edges of the display.
  121.         The value of 'pixel' also defines  the  maximum  number  of  colors
  122.    within  an  image.   The  range  of  values  for 'pixel' is 0 to 7 which
  123.    represents 1 to 8 bits.  This translates to a range of 2 (B & W) to  256
  124.    colors.   Bit  3 of word 5 is reserved for future definition and must be
  125.    zero.
  126. Graphics Interchange Format (GIF)                                    Page 5
  127. Specification
  128.  GLOBAL COLOR MAP
  129.         The Global Color Map is optional but recommended for  images  where
  130.    accurate color rendition is desired.  The existence of this color map is
  131.    indicated in the 'M' field of byte 5 of the Screen Descriptor.  A  color
  132.    map  can  also  be associated with each image in a GIF file as described
  133.    later.  However this  global  map  will  normally  be  used  because  of
  134.    hardware  restrictions  in equipment available today.  In the individual
  135.    Image Descriptors the 'M' flag will normally be  zero.   If  the  Global
  136.    Color  Map  is  present,  it's definition immediately follows the Screen
  137.    Descriptor.   The  number  of  color  map  entries  following  a  Screen
  138.    Descriptor  is equal to 2**(# bits per pixel), where each entry consists
  139.    of three byte values representing the relative intensities of red, green
  140.    and blue respectively.  The structure of the Color Map block is:
  141.               bits
  142.          7 6 5 4 3 2 1 0  Byte #
  143.         +---------------+
  144.         | red intensity |  1    Red value for color index 0
  145.         +---------------+
  146.         |green intensity|  2    Green value for color index 0
  147.         +---------------+
  148.         | blue intensity|  3    Blue value for color index 0
  149.         +---------------+
  150.         | red intensity |  4    Red value for color index 1
  151.         +---------------+
  152.         |green intensity|  5    Green value for color index 1
  153.         +---------------+
  154.         | blue intensity|  6    Blue value for color index 1
  155.         +---------------+
  156.         :               :       (Continues for remaining colors)
  157.         Each image pixel value received will be displayed according to  its
  158.    closest match with an available color of the display based on this color
  159.    map.  The color components represent a fractional intensity  value  from
  160.    none  (0)  to  full (255).  White would be represented as (255,255,255),
  161.    black as (0,0,0) and medium yellow as (180,180,0).  For display, if  the
  162.    device  supports fewer than 8 bits per color component, the higher order
  163.    bits of each component are used.  In the creation of  a  GIF  color  map
  164.    entry  with  hardware  supporting  fewer  than 8 bits per component, the
  165.    component values for the hardware  should  be  converted  to  the  8-bit
  166.    format with the following calculation:
  167.         <map_value> = <component_value>*255/(2**<nbits> -1)
  168.         This assures accurate translation of colors for all  displays.   In
  169.    the  cases  of  creating  GIF images from hardware without color palette
  170.    capability, a fixed palette should be created  based  on  the  available
  171.    display  colors for that hardware.  If no Global Color Map is indicated,
  172.    a default color map is generated internally  which  maps  each  possible
  173.    incoming  color  index to the same hardware color index modulo <n> where
  174.    <n> is the number of available hardware colors.
  175. Graphics Interchange Format (GIF)                                    Page 6
  176. Specification
  177.  IMAGE DESCRIPTOR
  178.         The Image Descriptor defines the actual placement  and  extents  of
  179.    the  following  image within the space defined in the Screen Descriptor.
  180.    Also defined are flags to indicate the presence of a local color  lookup
  181.    map, and to define the pixel display sequence.  Each Image Descriptor is
  182.    introduced by an image separator  character.   The  role  of  the  Image
  183.    Separator  is simply to provide a synchronization character to introduce
  184.    an Image Descriptor.  This is desirable if a GIF file happens to contain
  185.    more  than  one  image.   This  character  is defined as 0x2C hex or ','
  186.    (comma).  When this character is encountered between images,  the  Image
  187.    Descriptor will follow immediately.
  188.         Any characters encountered between the end of a previous image  and
  189.    the image separator character are to be ignored.  This allows future GIF
  190.    enhancements to be present in newer image formats and yet ignored safely
  191.    by older software decoders.
  192.               bits
  193.          7 6 5 4 3 2 1 0  Byte #
  194.         +---------------+
  195.         |0 0 1 0 1 1 0 0|  1    ',' - Image separator character
  196.         +---------------+
  197.         |               |  2    Start of image in pixels from the
  198.         +-  Image Left -+       left side of the screen (LSB first)
  199.         |               |  3
  200.         +---------------+
  201.         |               |  4
  202.         +-  Image Top  -+       Start of image in pixels from the
  203.         |               |  5    top of the screen (LSB first)
  204.         +---------------+
  205.         |               |  6
  206.         +- Image Width -+       Width of the image in pixels (LSB first)
  207.         |               |  7
  208.         +---------------+
  209.         |               |  8
  210.         +- Image Height-+       Height of the image in pixels (LSB first)
  211.         |               |  9
  212.         +-+-+-+-+-+-----+       M=0 - Use global color map, ignore 'pixel'
  213.         |M|I|0|0|0|pixel| 10    M=1 - Local color map follows, use 'pixel'
  214.         +-+-+-+-+-+-----+       I=0 - Image formatted in Sequential order
  215.                                 I=1 - Image formatted in Interlaced order
  216.                                 pixel+1 - # bits per pixel for this image
  217.         The specifications for the image position and size must be confined
  218.    to  the  dimensions defined by the Screen Descriptor.  On the other hand
  219.    it is not necessary that the image fill the entire screen defined.
  220.  LOCAL COLOR MAP
  221. Graphics Interchange Format (GIF)                                    Page 7
  222. Specification
  223.         A Local Color Map is optional and defined here for future use.   If
  224.    the  'M' bit of byte 10 of the Image Descriptor is set, then a color map
  225.    follows the Image Descriptor that applies only to the  following  image.
  226.    At the end of the image, the color map will revert to that defined after
  227.    the Screen Descriptor.  Note that the 'pixel' field of byte  10  of  the
  228.    Image  Descriptor  is used only if a Local Color Map is indicated.  This
  229.    defines the parameters not only for the image pixel size, but determines
  230.    the  number  of color map entries that follow.  The bits per pixel value
  231.    will also revert to the value specified in the  Screen  Descriptor  when
  232.    processing of the image is complete.
  233.  RASTER DATA
  234.         The format of the actual image is defined as the  series  of  pixel
  235.    color  index  values that make up the image.  The pixels are stored left
  236.    to right sequentially for an image row.  By default each  image  row  is
  237.    written  sequentially, top to bottom.  In the case that the Interlace or
  238.    'I' bit is set in byte 10 of the Image Descriptor then the row order  of
  239.    the  image  display  follows  a  four-pass process in which the image is
  240.    filled in by widely spaced rows.  The first pass writes every  8th  row,
  241.    starting  with  the top row of the image window.  The second pass writes
  242.    every 8th row starting at the fifth row from the top.   The  third  pass
  243.    writes every 4th row starting at the third row from the top.  The fourth
  244.    pass completes the image, writing  every  other  row,  starting  at  the
  245.    second row from the top.  A graphic description of this process follows:
  246.    Image
  247.    Row  Pass 1  Pass 2  Pass 3  Pass 4          Result
  248.    ---------------------------------------------------
  249.      0  **1a**                                  **1a**
  250.      1                          **4a**          **4a**
  251.      2                  **3a**                  **3a**
  252.      3                          **4b**          **4b**
  253.      4          **2a**                          **2a**
  254.      5                          **4c**          **4c**
  255.      6                  **3b**                  **3b**
  256.      7                          **4d**          **4d**
  257.      8  **1b**                                  **1b**
  258.      9                          **4e**          **4e**
  259.     10                  **3c**                  **3c**
  260.     11                          **4f**          **4f**
  261.     12          **2b**                          **2b**
  262.    . . . 
  263.         The image pixel values are processed as a series of  color  indices
  264.    which  map  into the existing color map.  The resulting color value from
  265.    the map is what is actually displayed.  This series  of  pixel  indices,
  266.    the  number  of  which  is equal to image-width*image-height pixels, are
  267.    passed to the GIF image data stream one value per pixel, compressed  and
  268.    packaged  according  to  a  version  of the LZW compression algorithm as
  269.    defined in Appendix C.
  270. Graphics Interchange Format (GIF)                                    Page 8
  271. Specification
  272.  GIF TERMINATOR
  273.         In order to provide a synchronization for the termination of a  GIF
  274.    image  file,  a  GIF  decoder  will process the end of GIF mode when the
  275.    character 0x3B hex or ';' is found after an image  has  been  processed.
  276.    By  convention  the  decoding software will pause and wait for an action
  277.    indicating that the user is ready to continue.  This may be  a  carriage
  278.    return  entered  at  the  keyboard  or  a  mouse click.  For interactive
  279.    applications this user action must  be  passed  on  to  the  host  as  a
  280.    carriage  return  character  so  that the host application can continue.
  281.    The decoding software will then typically leave graphics mode and resume
  282.    any previous process.
  283.  GIF EXTENSION BLOCKS
  284.         To provide for orderly extension of the GIF definition, a mechanism
  285.    for  defining  the  packaging  of extensions within a GIF data stream is
  286.    necessary.  Specific GIF extensions are to be defined and documented  by
  287.    CompuServe in order to provide a controlled enhancement path.
  288.         GIF Extension Blocks are packaged in a manner similar to that  used
  289.    by the raster data though not compressed.  The basic structure is:
  290.          7 6 5 4 3 2 1 0  Byte #
  291.         +---------------+
  292.         |0 0 1 0 0 0 0 1|  1       '!' - GIF Extension Block Introducer
  293.         +---------------+
  294.         | function code |  2       Extension function code (0 to 255)
  295.         +---------------+    ---+
  296.         |  byte count   |       |
  297.         +---------------+       |
  298.         :               :       +-- Repeated as many times as necessary
  299.         |func data bytes|       |
  300.         :               :       |
  301.         +---------------+    ---+
  302.         . . .       . . .
  303.         +---------------+
  304.         |0 0 0 0 0 0 0 0|       zero byte count (terminates block)
  305.         +---------------+
  306.         A GIF Extension Block may immediately preceed any Image  Descriptor
  307.    or occur before the GIF Terminator.
  308.         All GIF decoders must be able to recognize  the  existence  of  GIF
  309.    Extension  Blocks  and  read past them if unable to process the function
  310.    code.  This ensures that older decoders will be able to process extended
  311.    GIF   image   files   in  the  future,  though  without  the  additional
  312.    functionality.
  313. Graphics Interchange Format (GIF)                                    Page 9
  314. Appendix A - Glossary
  315.                                  GLOSSARY
  316. Pixel - The smallest picture element of a  graphics  image.   This  usually
  317.    corresponds  to  a single dot on a graphics screen.  Image resolution is
  318.    typically given in units of  pixels.   For  example  a  fairly  standard
  319.    graphics  screen  format  is  one 320 pixels across and 200 pixels high.
  320.    Each pixel can  appear  as  one  of  several  colors  depending  on  the
  321.    capabilities of the graphics hardware.
  322. Raster - A horizontal row of pixels representing one line of an  image.   A
  323.    typical method of working with images since most hardware is oriented to
  324.    work most efficiently in this manner.
  325. LSB - Least Significant Byte.  Refers to a convention for two byte  numeric
  326.    values in which the less significant byte of the value preceeds the more
  327.    significant byte.  This convention is typical on many microcomputers.
  328. Color Map - The list of definitions of each color  used  in  a  GIF  image.
  329.    These  desired  colors are converted to available colors through a table
  330.    which is derived by assigning an incoming color index (from  the  image)
  331.    to  an  output  color  index  (of  the  hardware).   While the color map
  332.    definitons are specified in a GIF image, the output  pixel  colors  will
  333.    vary  based  on  the  hardware used and its ability to match the defined
  334.    color.
  335. Interlace - The method of displaying a GIF image in which  multiple  passes
  336.    are  made,  outputting  raster  lines  spaced  apart to provide a way of
  337.    visualizing the general content of an entire image  before  all  of  the
  338.    data has been processed.
  339. B Protocol - A CompuServe-developed error-correcting file transfer protocol
  340.    available  in  the  public  domain  and implemented in CompuServe VIDTEX
  341.    products.  This error checking mechanism will be used  in  transfers  of
  342.    GIF images for interactive applications.
  343. LZW - A sophisticated data compression algorithm  based  on  work  done  by
  344.    Lempel-Ziv  &  Welch  which  has  the feature of very efficient one-pass
  345.    encoding and decoding.  This allows the image  to  be  decompressed  and
  346.    displayed  at  the  same  time.   The  original  article from which this
  347.    technique was adapted is:
  348.           Terry  A.   Welch,  "A  Technique  for  High   Performance   Data
  349.           Compression", IEEE Computer, vol 17 no 6 (June 1984)
  350.         This basic algorithm is also used in the  public  domain  ARC  file
  351.    compression  utilities.   The  CompuServe  adaptation  of LZW for GIF is
  352.    described in Appendix C.
  353. Graphics Interchange Format (GIF)                                   Page 10
  354. Appendix B - Interactive Sequences
  355.            GIF Sequence Exchanges for an Interactive Environment
  356.         The following sequences are defined for use  in  mediating  control
  357.    between a GIF sender and GIF receiver over an interactive communications
  358.    line.  These  sequences  do  not  apply  to  applications  that  involve
  359.    downloading  of  static  GIF  files and are not considered part of a GIF
  360.    file.
  361.  GIF CAPABILITIES ENQUIRY
  362.         The GCE sequence is issued from a host and requests an  interactive
  363.    GIF  decoder  to  return  a  response  message that defines the graphics
  364.    parameters for the decoder.  This involves returning  information  about
  365.    available screen sizes, number of bits/color supported and the amount of
  366.    color detail supported.  The escape sequence for the GCE is defined as:
  367.         ESC [ > 0 g     (g is lower case, spaces inserted for clarity)
  368.                          (0x1B 0x5B 0x3E 0x30 0x67)
  369.  GIF CAPABILITIES RESPONSE
  370.         The GIF Capabilities Response message is returned by an interactive
  371.    GIF  decoder  and  defines  the  decoder's  display capabilities for all
  372.    graphics modes that are supported by the software.  Note that  this  can
  373.    also include graphics printers as well as a monitor screen.  The general
  374.    format of this message is:
  375.      #version;protocol{;dev, width, height, color-bits, color-res}... <CR>
  376.    '#'          - GCR identifier character (Number Sign)
  377.    version      - GIF format version number;  initially '87a'
  378.    protocol='0' - No end-to-end protocol supported by decoder
  379.                   Transfer as direct 8-bit data stream.
  380.    protocol='1' - Can use an error correction protocol to transfer GIF data
  381.                interactively from the host directly to the display.
  382.    dev = '0'    - Screen parameter set follows
  383.    dev = '1'    - Printer parameter set follows
  384.    width        - Maximum supported display width in pixels
  385.    height       - Maximum supported display height in pixels
  386.    color-bits   - Number of  bits  per  pixel  supported.   The  number  of
  387.                supported colors is therefore 2**color-bits.
  388.    color-res    - Number of bits  per  color  component  supported  in  the
  389.                hardware  color  palette.   If  color-res  is  '0'  then  no
  390.                hardware palette table is available.
  391.         Note that all values in the  GCR  are  returned  as  ASCII  decimal
  392.    numbers and the message is terminated by a Carriage Return character.
  393. Graphics Interchange Format (GIF)                                   Page 11
  394. Appendix B - Interactive Sequences
  395.         The  following   GCR   message   describes   three   standard   EGA
  396.    configurations  with  no  printer;  the GIF data stream can be processed
  397.    within an error correcting protocol:
  398.         #87a;1 ;0,320,200,4,0 ;0,640,200,2,2 ;0,640,350,4,2<CR>
  399.  ENTER GIF GRAPHICS MODE
  400.         Two sequences are currently defined to invoke  an  interactive  GIF
  401.    decoder into action.  The only difference between them is that different
  402.    output media are selected.  These sequences are:
  403.      ESC [ > 1 g   Display GIF image on screen
  404.                    (0x1B 0x5B 0x3E 0x31 0x67)
  405.      ESC [ > 2 g   Display image directly to an attached graphics  printer.
  406.                    The  image  may optionally be displayed on the screen as
  407.                    well.
  408.                    (0x1B 0x5B 0x3E 0x32 0x67)
  409.         Note that the 'g' character terminating each sequence is  in  lower
  410.    case.
  411.  INTERACTIVE ENVIRONMENT
  412.         The assumed environment for the transmission of GIF image data from
  413.    an  interactive  application  is  a  full 8-bit data stream from host to
  414.    micro.  All 256 character codes must be transferrable.  The establishing
  415.    of  an 8-bit data path for communications will normally be taken care of
  416.    by the host application programs.  It is however  up  to  the  receiving
  417.    communications programs supporting GIF to be able to receive and pass on
  418.    all 256 8-bit codes to the GIF decoder software.
  419. Graphics Interchange Format (GIF)                                   Page 12
  420. Appendix C - Image Packaging & Compression
  421.         The Raster Data stream that represents the actual output image  can
  422.    be represented as:
  423.          7 6 5 4 3 2 1 0
  424.         +---------------+
  425.         |   code size   | 
  426.         +---------------+     ---+
  427.         |blok byte count|        |
  428.         +---------------+        |
  429.         :               :        +-- Repeated as many times as necessary
  430.         |  data bytes   |        |
  431.         :               :        |
  432.         +---------------+     ---+
  433.         . . .       . . .
  434.         +---------------+
  435.         |0 0 0 0 0 0 0 0|       zero byte count (terminates data stream)
  436.         +---------------+
  437.         The conversion of the image from a series  of  pixel  values  to  a
  438.    transmitted or stored character stream involves several steps.  In brief
  439.    these steps are:
  440.    1.  Establish the Code Size -  Define  the  number  of  bits  needed  to
  441.        represent the actual data.
  442.    2.  Compress the Data - Compress the series of image pixels to a  series
  443.        of compression codes.
  444.    3.  Build a Series of Bytes - Take the  set  of  compression  codes  and
  445.        convert to a string of 8-bit bytes.
  446.    4.  Package the Bytes - Package sets of bytes into blocks  preceeded  by
  447.        character counts and output.
  448. ESTABLISH CODE SIZE
  449.         The first byte of the GIF Raster Data stream is a value  indicating
  450.    the minimum number of bits required to represent the set of actual pixel
  451.    values.  Normally this will be the same as the  number  of  color  bits.
  452.    Because  of  some  algorithmic constraints however, black & white images
  453.    which have one color bit must be indicated as having a code size  of  2.
  454.    This  code size value also implies that the compression codes must start
  455.    out one bit longer.
  456. COMPRESSION
  457.         The LZW algorithm converts a series of data values into a series of
  458.    codes  which may be raw values or a code designating a series of values.
  459.    Using text characters as an analogy,  the  output  code  consists  of  a
  460.    character or a code representing a string of characters.
  461. Graphics Interchange Format (GIF)                                   Page 13
  462. Appendix C - Image Packaging & Compression
  463.         The LZW algorithm used in  GIF  matches  algorithmically  with  the
  464.    standard LZW algorithm with the following differences:
  465.    1.  A   special   Clear   code   is    defined    which    resets    all
  466.        compression/decompression parameters and tables to a start-up state.
  467.        The value of this code is 2**<code size>.  For example if  the  code
  468.        size  indicated  was 4 (image was 4 bits/pixel) the Clear code value
  469.        would be 16 (10000 binary).  The Clear code can appear at any  point
  470.        in the image data stream and therefore requires the LZW algorithm to
  471.        process succeeding codes as if  a  new  data  stream  was  starting.
  472.        Encoders  should output a Clear code as the first code of each image
  473.        data stream.
  474.    2.  An End of Information code is defined that explicitly indicates  the
  475.        end  of  the image data stream.  LZW processing terminates when this
  476.        code is encountered.  It must be the last code output by the encoder
  477.        for an image.  The value of this code is <Clear code>+1.
  478.    3.  The first available compression code value is <Clear code>+2.
  479.    4.  The output codes are of variable length, starting  at  <code size>+1
  480.        bits  per code, up to 12 bits per code.  This defines a maximum code
  481.        value of 4095 (hex FFF).  Whenever the LZW code value  would  exceed
  482.        the  current  code length, the code length is increased by one.  The
  483.        packing/unpacking of these codes must then be altered to reflect the
  484.        new code length.
  485. BUILD 8-BIT BYTES
  486.         Because the LZW compression  used  for  GIF  creates  a  series  of
  487.    variable  length  codes, of between 3 and 12 bits each, these codes must
  488.    be reformed into a series of 8-bit bytes that  will  be  the  characters
  489.    actually stored or transmitted.  This provides additional compression of
  490.    the image.  The codes are formed into a stream of bits as if  they  were
  491.    packed  right to left and then picked off 8 bits at a time to be output.
  492.    Assuming a character array of 8 bits per character and using 5 bit codes
  493.    to be packed, an example layout would be similar to:
  494.          byte n       byte 5   byte 4   byte 3   byte 2   byte 1
  495.         +-.....-----+--------+--------+--------+--------+--------+
  496.         | and so on |hhhhhggg|ggfffffe|eeeedddd|dcccccbb|bbbaaaaa|
  497.         +-.....-----+--------+--------+--------+--------+--------+
  498.         Note that the physical  packing  arrangement  will  change  as  the
  499.    number  of  bits per compression code change but the concept remains the
  500.    same.
  501. PACKAGE THE BYTES
  502.         Once the bytes have been created, they are grouped into blocks  for
  503.    output by preceeding each block of 0 to 255 bytes with a character count
  504.    byte.  A block with a zero byte count terminates the Raster Data  stream
  505.    for  a  given  image.  These blocks are what are actually output for the
  506. Graphics Interchange Format (GIF)                                   Page 14
  507. Appendix C - Image Packaging & Compression
  508.    GIF image.  This block format has the side effect of allowing a decoding
  509.    program  the  ability to read past the actual image data if necessary by
  510.    reading block counts and then skipping over the data.
  511. Graphics Interchange Format (GIF)                                   Page 15
  512. Appendix D - Multiple Image Processing
  513.         Since a  GIF  data  stream  can  contain  multiple  images,  it  is
  514.    necessary  to  describe  processing and display of such a file.  Because
  515.    the image descriptor allows  for  placement  of  the  image  within  the
  516.    logical  screen,  it is possible to define a sequence of images that may
  517.    each be a partial screen, but in total  fill  the  entire  screen.   The
  518.    guidelines for handling the multiple image situation are:
  519.    1.  There is no pause between images.  Each is processed immediately  as
  520.        seen by the decoder.
  521.    2.  Each image explicitly overwrites any image  already  on  the  screen
  522.        inside  of  its window.  The only screen clears are at the beginning
  523.        and end of the  GIF  image  process.   See  discussion  on  the  GIF
  524.        terminator.
  525. 4444444444444444444444444444444444444444444444444444444444444444444444444444
  526.